home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / Development / PowerD / powerd / docs / ddbg.readme < prev    next >
Encoding:
Text File  |  2002-10-28  |  3.2 KB  |  103 lines
  1. Short:    At last a (68k) debugger for PowerD! :)
  2. Author:   Martin Kuchinka
  3. Uploader: kuchinka@volny.cz
  4. Type:     dev/e
  5. Version:  0.2, 23.6.2002
  6. Requires: OS3.0+, 68020, PowerD 0.19 full or newer!
  7.  
  8. This is first release of heavily buggy software ;) It will very extent in
  9. near or far future. Too much have to be done, it's that buggy, that it's
  10. unusable ;) But it works, and that's important.
  11.  
  12.  
  13.   Test:
  14.  
  15. Please enter:
  16.  
  17. 1.> ddbg test
  18.  
  19. and play with this source :) This is the only source I have currently tested
  20. and it works nearly correctly ;)
  21.  
  22.  
  23.   Usage:
  24.  
  25. To compile a source to be debugged, You have to compile it with two args:
  26.  
  27. 1.> dc proggy debug ds
  28.  
  29. - debug to create a debug file and line labels
  30. - ds to be able to store the needed labels within the executable
  31.  
  32. The ds argument won't be needed in one of next releases of PowerD.
  33.  
  34. And to debug the proggy enter:
  35.  
  36. 1.> ddbg proggy
  37.  
  38. Two windows will open, and some text will appear in the output window.
  39. First window has some buttons, currently only the first one is usable.
  40. This button traces single line of the PowerD source. Try and see. I know
  41. it's damn small number of programm flow control functions, but... it's
  42. just 0.1 ;) It has also some menu items, guess, what's Find and Next ;)
  43. Jump to line is also clear, I suppose. Registers shows contents of
  44. all the cpu's registers, not much usable. Variables shows all available
  45. local (sorry, no global today) variables and it's contants. Very limited,
  46. can't be changed yet.
  47. And the second opened window contains the source code. Line to be executed
  48. is black. No scrollbar yet. Lines of the source are visible for easier
  49. orientation in the source code...
  50. The only window, that can be used (by Your mouse or keyboard) is the window
  51. with buttons, all others can only change it's size.
  52. Hope, that's all for now.
  53.  
  54.  
  55.   Bugs:
  56.  
  57. Ehh, too much, it's very probably, that there can't be debugged correctly
  58. more compact sources, only very simple currently. But:
  59.  
  60.   - sometimes ddbg shows bad line to be executed, this isn't bug in ddbg,
  61.     but in PowerD. Will be fixed asap.
  62.     - as tested, it contains big number of enforcer hits (hope read only ;)
  63.     so, don't try to find enforcer hits in Your code.
  64.  
  65. Please, don't email me about bugs, too much are there. I know it. And I'll
  66. fix them as fast as possible. Check my homepage (www.volny.cz/kuchinka) for
  67. updates.
  68.  
  69.  
  70.   Next release:
  71. - support of arguments
  72. - Raise an exception ability
  73. - run time stop ability
  74.  
  75.  
  76.   Future (in no partucular order):
  77.  
  78. - change contents of variables (and registers)
  79. - scroll bars for all windows
  80. - disassembler (this is already built in (very basicaly) and can work, to
  81.   use it, watch source, and uncomment some lines from the Test() procedure)
  82. - debug inline ASM
  83. - break a running code and find the position in the source (!)
  84. - speedup
  85. - and more and more
  86.  
  87.  
  88.   History:
  89.  
  90. - pre 0.1 is forgotten ;)
  91. - 0.2 (23.6.2002)
  92.   - added support for global variables (requires dc 0.19 full)
  93.   - added 'Refresh' menu item
  94.   - added step over ability
  95.  
  96.   Thankx:
  97.  
  98. First, most important is to Zbigniew `Zeeball` Trzcionkowski, for his
  99. tracing routine. Without it, I wouldn't ever be able to write it.
  100. (has anyone a ppc tracing routine? ;)
  101. Tomasz Wiszkowski, for being my best friend ever!!!
  102. And all my bugreporters, who forced me to write this piece of crap ;)
  103.